Inside Macintosh: Open Transport /

Chapter 2 - Providers / Providers Reference

Functions / Controlling a Provider's Mode of Operation

OTSetAsynchronous

Sets a provider's mode of execution to asynchronous.

C INTERFACE

OSStatus OTSetAsynchronous(ProviderRef ref);

C++ INTERFACE

OSStatus TProvider::SetAsynchronous();

PARAMETERS

ref

The provider reference of the provider whose mode of execution you want to set.

DESCRIPTION

The OTSetAsynchronous function causes all functions for the provider specified in the ref parameter to run asynchronously. You must install a notifier function for the provider if it needs to receive completion events. You can install a notifier function either before or after calling the OTSetAsynchronous function.

Changing a provider's mode of execution does not affect its notifier function, if any; the notifier function remains installed.

SEE ALSO

Provider events are described in "Provider Events" on page 2-7.

Modes of operation and notifier functions are described in "Specifying How Provider Functions Execute" on page 2-9.

To set a provider to asynchronous mode, call the OTSetAsynchronous function (page 2-29). To find out a provider's mode of execution, call the OTIsSynchronous function (page 2-30).